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0 An event system is provided within an object-oriented environment. The event system informs users and 
system functions of events within the system. Events may be modeled as objects that are visible within the 
global namespace. These objects include event source objects and event sink objects. Event source objects 
generate event reports and event sink objects are the objects that receive reports. Special objects may be 
incorporated in the system to direct event reports from an event source object to an event sink object. 
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report from the event source object. As part of the registration, an instance of a function in an interface io 
be called by the event report as received by the event sink object is specified. 

Brief Description of the Drawings 

5 

Figure 1 is a block diagram of a data processing system that is suitable for practicing a preferred 
embodiment of the present invention. 

Figure 2A is a block diagram illustrating an instance of the preferred embodiment in which a single 
event report is sent from a single event source to a single event sink. 
>o Figure 2B is a block diagram illustrating an instance of the preferred embodiment in which a single 
event report is sent from a single event source to multiple event sinks. 

Figure 2C is a block diagram illustrating an instance of the preferred embodiment m which multiDle 
event sources send multiple event reports to a single event sink. 

Figure 2D is a block diagram illustrating an instance of the preferred embodiment in which a single 
'5 event source sends multiple event reports to multiple event sinks. 

Figure 3 is a diagram of the run time data structures used for interfaces by the preferred embodiment 
to the present invention. 

Figure 4 is a diagram of objects that play a role in the preferred embodiment of the present invention to 
register an event sink object with an event source object to receive event reports. 
20 Figure 5 is a flowchart illustrating the steps performed by the preferred embodiment to register an event 
sink object with an event source object to receive event reports. 

Figure 6 is a flowchart illustrating steps performed by the preferred embodiment of the present 
invention in generating and processing event reports. 

Figure 7 is a block diagram of a preferred embodiment of the present invention when a distributor 
25 object is employed. 

Figure 8 is a block diagram illustrating propagation of an event rePort from a first distributor object to a 
second distributor object in accordance with a preferred embodiment of the present invention. 

Detailed Description of the Invention 

30 

A preferred embodiment of the present invention provides an event system architecture for generating 
system management events. The architecture is designed to be easily used and to require minimal 
overhead. The system management events notify processes of certain states. 

Figure 1 shows an illustrative data processing system 10 for practicing a preferred embodiment of the 

35 present invention. Those skilled in the art will appreciate that other types of data processing systems may 
be used for practicing the present invention. The data processing system 10 includes a central processing 
unit (CPU) 12 that oversees activities of the system. The CPU 12 communicates with a memory 14. a 
keyboard 16. a video display 18. a printer 19 and a mouse 24. The memory 14 holds an object-oriented 
operating system 20 that includes an event system 22. Although the operating system 20 of the preferred 

-io embodiment is an object-oriented operating system, those skilled m the art will appreciate that the present 
invention is not limited to such an object-oriented environment. The keyboard 16 and mouse 24 are 
conventional input devices, and the video display 18 and printer 19 are conventional output devices. 

The event system 22 is responsible for overseeing the generation and transmission of event reports that 
report the occurrence of particular events in the system 10. An "event." in this context, is an asyn- 

js chronousiy arising condition relative to a destination process that wishes to be informed of the event. The 
process in which the condition arises is the "event source," whereas the process to which the event is 
reported is the "event sink." An "event report" reports an event and is transmitted from the event source to 
the event sink (as will be described in more detail below). The event source and event sink are objects that 
are visible in a distributed namespace of the system 10. The distributed namespace is a logical organization 

50 of the "names of objects" (described in more detail below) that are stored in the system 10. 

The preferred embodiment of the present invention allows application programs run on the system 10 
(Figure 1) to generate and receive information about external events without possessing knowledge about 
the events or the sources of the events. It provides a means for an event sink 27 (Figure 2A) to register with 
an event source 23 to receive an event report 25. The event sink 27 may then invoke an event handler to 

55 respond to the occurrence of the event. The design of the preferred embodiment leverages the distributed 
namespace of the system to provide places for event sinks, to register. The preferred embodiment also 
provides a means to send the event report from the event source to the event sink. 
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preferred embodiment of the present invention to establish connections between an event source and an 
event sink. This process wilt be described below as "registration". 

Before discussing how an event sink registers with an event source to receive event reports, it is heipfui 
to consider how events are defined relative to the objects that may generate them. In generai. an object 
specifies an event set of events that it is capable of generating. The event set is part of the object's 
definition and is described in type information provided for the object. The type information may be stored 
tn a storage structure that is separate from the object. The type information specifies which events are 
provided m the objects of that set. Consider as an example as object that -supports an event set known as 
the DiskEventSet. This event set is identified as follows: 



DiskS pace Lowl DiskS pace Event psEvent); 
D is kfullf DiskS pace Event ps Event); 
DiskErrorf DiskErrorEvenx psEvent) 



DiskSpaceEvent is a property set that may be defined as follows: 



propset DiskSpaceEvent : public Di.sk Event 
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{ 



} 



LARGE_INTEGER 
LARGE INTEGER 



{ 



} 



ULONG 
WCHAR 
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propset ISystemEvent 

{ 

mandatory: 

SYSTTME 

UUTD 

ULONG 

UUTD 

ULONG 

ULONG 

> 



D iskS paccAvailable ; 
TotalDiskSpace; 



propset DiskEvent : public ISystemEvent 



UTVoiumelD; 
pwzVolumeName; 



umeEventCreationTime; 

uuidCIassid; 

sevSeveriry; 

uuidCategorylD; 

ulEventCode; 

uiHopCount: 
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Before discussing the registration process in more detail, it is useful to first introduce the objects which 
play a role within this registration process. Figure 4 is a diagram illustrating an example situation wherein 
the objects that play a role in registration are used. Figure 4 illustrates an instance wherein a printer 46 
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A system may also include special objects, known as "distributor objects." A distributor object >s an 

object which exists in the global namespace to route event reports to event sinks. Figure 7 depicts a 

distributor object 82 that receives event reports from event sources 80. 80' ana 80". The distributor object 

82 provides both event source and event sink functionalities. The distributor object 82 rouies the event 
5 reports received from the event sources 80. 80' and 80" to event sinks 84. 84' and 84". Distributor objects 

32 are useful m grouping event sources and sinks as sets. For example, a distributor may be used to 

represent all administrators on a gtven domain. 

A distributor object may also be configured to propagate event reports to other distributor objects. 

Figure 3 shows an example of a situation m which a distributor object 88 receives an event report 92 from 
:q an event source 86 and propagates the event report to a second distributor object 90. The difference 

between this type of propagation and the propagation that occurs with normal registration is that filtering 

information 94 stored on the second distributor object 90 is forwarded to the first distributor object 88. This 

filtering information specifies which type of event report the distributor object 90 is interested tn obtaining. 

The first distributor object 88 filters the incoming event reports 92 to determine whether the second 
■ 5 distributor object 90 wishes to receive the event report. The filtering information 94 is stored on the second 

distributor object m such a way that it is available to any distributor object that is registered to propagate 

event reports to the second distributor object. 

The operating system 20 provides a number of dispatch interfaces. A dispatch interface, in this context. 

is as defined in the Microsoft Object Linking and Embedding (OLE) 2.0 protocol, established by Microsoft 
20 Corporation of Redmond. Washington. Dispatch interfaces allow access to methods, properties and data 

members of objects whose interface is not known. Each dispatch interface has functions that allow a caller 

to retrieve and send property values. The event distributor objects have the ability to call any dispatchabie 

interface. Parameter information is stored with the registration information for the event sink object. 

Prooerties are set on the software connector to the event sink in the event source such that each 
25 registration can have its own interface to be called. As an example, this capability allows a system event to 

trigger the printing of a word processing document through the call to the unique interface associated with 

the registration of an event sink. 

It should be appreciated that registrations may be maintained over a period of time. Registrations are 

not strictly a one-time phenomena. The registration need not be deleted after a single event occurs. 
30 Maintaining the registration is helpful in performing functions such as logging. Logging involves recording 

event reports in a file to create a log. The log may be later viewed to provide a historical record of .activity 

of a part of the system. 

A preferred embodiment of the present invention enhances the ability of system administration 
functions to become aware of relevant events within the system. This capability stems, in large part, from 
35 segregating the occurrence of an event from the response to the event. The preferred embodiment also 
facilitates segregation by event type so that the system administrator may be aware of the different types of 
events and respond accordingly. 

Since event reports are objects in the global namespace, both users and system components have 
access to the event reports. The event reports include important state information that may be used by 
-io users and system components alike. The user has the ability to discover what events a program is capable 
of generating and can register to receive notice of any such events. 

While the present invention has been described with reference to a preferred embodiment thereof, 
those skilled in the art will appreciate that various changes in form and scope may be made without 
departing from the present invention as defined in the appended claims. For instance, the present invention 
■15 need not be practiced m a single processor system like that shown in Figure 1: rather the present invention 
may also be practiced in a distributed system. 

Claims 

so 1. In a data processing system having memory means and processing means, a method comprising the 
steps of: 

storing a global namespace of objects in the memory means; 

providing event source objects for generating event reports in response to events at the event 
source objects, an event sink object for receiving event reports and a distributor object for distributing 
55 event reports from the event source objects to the event sink object; 
triggering an event at one of the event source objects: 

generating an event report at the event source object where the event was triggered; 
forwarding the event report to the distributor object; and 

7 



3NSOOCIO:<EP 065t329Al> 



EP 0 651 328 A1 



14. In a data processing system having memory means and processing means, a method comprising :ne 
steps of: 

providing at least one event source object m the memory means for generating an event report m 
response to an event at the event source object: 
5 providing a first distributor object and a second distributor object in the memory means, said first 

distributor object serving to distribute the event report when generated by the event source object ;o 
the second distributor object: 

triggering the event at the event source object: 

generating an event report at the event source object: 
w forwarding the event report to the first distributor object: 

providing filtering information from the second distributor object to the first distributor object, said 
filtering information specifying a type of event report that the second distributor object wishes to 
receive; and 

where the filtering information indicates that the second distributor object wishes to receive the 
is event report, forwarding the event report from the first distributor object to the second distributor object. 

15. In a data processing system having processing means and memory means, a method comprising the 
steps of: 

providing an event source object for generating an event report in response to an event and an 
20 event sink object for receiving the event report: and 

registering the event sink object to receive the event report from the event source object, wherein 
as part of the registration specifying an instance of a function in an interface to be cailed when the 
event report is received by the event sink object. 

25 16. The method of claim 15. further comprising the steps of: 
triggering the event at the event source object: 

generating the event report at the event source object and forwarding the event report to the event 
sink object: and 

in response to receiving the event report at the event sink object, invoking the function of [he 
30 instance of the interface specified in the registration. 
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